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Warranty and Disclaimer 


Warranty and Disclaimer 


To the maximum extent permitted by applicable law, Fujitsu Microelectronics Europe GmbH restricts 
its warranties and its liability for all products delivered free of charge (eg. software include or 
header files, application examples, target boards, evaluation boards, engineering samples of IC’s 
etc.), its performance and any consequential damages, on the use of the Product in accordance with 
(i) the terms of the License Agreement and the Sale and Purchase Agreement under which 
agreements the Product has been delivered, (ii) the technical descriptions and (iii) all accompanying 
written materials. In addition, to the maximum extent permitted by applicable law, Fujitsu 
Microelectronics Europe GmbH disclaims all warranties and liabilities for the performance of the 
Product and any consequential damages in cases of unauthorised decompiling and/or reverse 
engineering and/or disassembling. Note, all these products are intended and must only be used 
in an evaluation laboratory environment. 


1. Fujitsu Microelectronics Europe GmbH warrants that the Product will perform substantially in 
accordance with the accompanying written materials for a period of 90 days form the date of 
receipt by the customer. Concerning the hardware components of the Product, Fujitsu 
Microelectronics Europe GmbH warrants that the Product will be free from defects in material 
and workmanship under use and service as specified in the accompanying written materials 
for a duration of 1 year from the date of receipt by the customer. 


2. Should a Product turn out to be defect, Fujitsu Microelectronics Europe GmbH’s entire liability 
and the customer’s exclusive remedy shall be, at Fujitsu Microelectronics Europe GmbH’s 
sole discretion, either return of the purchase price and the license fee, or replacement of the 
Product or parts thereof, if the Product is returned to Fujitsu Microelectronics Europe GmbH in 
original packing and without further defects resulting from the customer’s use or the transport. 
However, this warranty is excluded if the defect has resulted from an accident not attributable 
to Fujitsu Microelectronics Europe GmbH, or abuse or misapplication attributable to the 
customer or any other third party not relating to Fujitsu Microelectronics Europe GmbH. 


3. To the maximum extent permitted by applicable law Fujitsu Microelectronics Europe GmbH 
disclaims all other warranties, whether expressed or implied, in particular, but not limited to, 
warranties of merchantability and fitness for a particular purpose for which the Product is not 
designated. 


4. To the maximum extent permitted by applicable law, Fujitsu Microelectronics Europe GmbH’s 
and its suppliers’ liability is restricted to intention and gross negligence. 


NO LIABILITY FOR CONSEQUENTIAL DAMAGES 


To the maximum extent permitted by applicable law, in no event shall Fujitsu 
Microelectronics Europe GmbH and its suppliers be liable for any damages whatsoever 
(including but without limitation, consequential and/or indirect damages for personal 
injury, assets of substantial value, loss of profits, interruption of business operation, 
loss of information, or any other monetary or pecuniary loss) arising from the use of 
the Product. 


Should one of the above stipulations be or become invalid and/or unenforceable, the remaining 
stipulations shall stay in full effect 
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Introduction 


O Introduction 


The MB2147-05 emulator system is a low cost emulator system which can be used for 
Fujitsu 16-Bit microcontrollers of the 16L/16LX Series. This application note should give a 
short guideline how to install an MB2147-05 emulation system. This guide describes on the 
one side the hardware installation configuration and shows on the other side how to install 
and configure the corresponding software development environment to allow users a quick 
start-up. 


This guide does not replace the Hardware Manual of MB2147-05. This guide is giving 
just a short introduction how to set-up and configure the emulator system 
environment. For more detailed information please check the corresponding hardware 
manual of MB2147-05. 


Note 


There may exist restrictions in supporting some microcontroller series, so please check first 
whether the used microcontroller evaluation chip can be supported by MB2147-05. Currently 
the MB2147-05 can only support evaluation chips based on 0.5um technology: 


MB906xx, MB905xx, MB90385, MB90420, MB90425, MB90435, MB90440, 
MB90455, MB90460, MB90470, MB90495 


The following series are not supported by this low cost emulation system: 
MB90340, MB90350, MB90390, MB90480 
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Chapter 1 Overview 


1 Overview 


1.1 Features of MB2147-05 low cost In-Circuit Emulator 


>» Supported Series 


MB906xx, MB905xx, MB90385, MB90420, MB90425, MB90435, MB90440, 
MB90455, MB90460, MB90470, MB90495 


>» Microcontroller operation frequency : max 25MHz 


>» Microcontroller operation voltage 1.8V — 5.5V — Voltage range (Max and Min) 
depends on microcontroller specification and operating frequency 


>» CPU Clock supply 
> 1MB emulation memory 
>» Status LEDs for emulator and CPU status indication 
> Fully Softune Workbench integrated user Interface 
>» Supports debugging on source level (assembly and C-source code) 
» Mixed source code view to debug C-code and assembly code 
> Display-Windows for Variables, Stack, Memory, CPU Registers, Watch window 
> Instruction- and Data breakpoints with data mask 
>» Function Call 
>» View of Vector Table 
>» Trace buffer 64KB with trace filter 
>» Time measurements via CPU clock cycle count 
>» Use of Fujitsu standard probe cables 
> Host Interface 
>» USB1.1 
» RS232 max. 115k Baud 
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1.2 Features Compared to MB2141A/B, MB2147-01 


Compared with the MB2141A/B and MB2147-01 emulator system some features are not 
supported by MB2147-05 or are restricted. The following table gives a short summary of the 
features and displays the differences between the emulation systems. 


Feature MB2147-05 MB2147-01 MB2141A MB2141B 
Emulation adapter 
MB2147-20: 
MB90385 MB903xx except 
MB90420 MB90385 
MB90425 MB90480 
MB90435 MB90385 MB90385 
MB90440 MB904xx except MB904xx except 
Supported Series Scan Emulation adapter MB90480 MB90480 
MB2147-10: 
MB90470 MB905xx MB905xx 
MB90495 MB90385 MB906xx MB906xx 
MB905xx MB904xx, except 
MB90480 
MB906xx 
MB905xx 
MB906xx 
Maximum 
Operating 24MHz 25MHz ai rereis iby eee 10 
Frequency 


Host Interface 


USB 1.1, RS232 


USB 1.1, LAN, RS232 


RS232, LAN via 
optional adapter 


RS232, LAN via 
optional adapter 


Instruction 


Breakpoints Yes Yes Yes Yes 

Data Breakpoints Yes Yes Yes Yes 

Sequential 

Breakpoints No 3 Events, 3 Levels 8 Events, 8 Levels 8 Events, 8 Levels 

External Trigger No Yes Yes Yes 

External Probe No Yes Yes Yes 

Trace Yes/64K Yes/64K Yes/64K Yes/64K 

Coverage No Yes Yes Yes 

Read-on the fly No Yes Yes Yes 

Time- Restricted to 

Maasuiemant CPU cycles Yes Yes Yes 
count 

Memory Window Yes Yes Yes Yes 

Stack Window Yes Yes Yes Yes 

Watch Window Yes Yes Yes Yes 

cru Register Yes Yes Yes Yes 

Window 

Source Code 

Mixed Mode view Yes Yes Yes Yes 

Emulation 

memory 1MB 1MB 3MB 3MB 
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Chapter 2 Hardware Installation 


2 Hardware Installation 


2.1 State of Delivery 
The following parts are included in the shipment of MB2147-05 
- MB2147-05 emulation unit 
- Power supply 
- RS232 cable 
- USB cable 
- CD-ROM with Softune Workbench Development environment 
- Floppy disk with MB2147-05 Hardware Manual 


The MB2147-05 is delivered with a CD-ROM containing the latest softune workbench 
development environment. Please take care that Softune ProPack3000013 or later must be 
used (Softune V30L28). Previous versions do not support MB2147-05. Additionally a floppy 
disk is included, which contains the hardware manual of the ICE. For any detailed hardware 
settings please check the hardware manual of the MB2147-05. 
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2.2 System Set-up 


The emulator system hardware is installed as shown on the following pictures. Please take 
care that a target system is connected via a probe cable to the emulator, otherwise 
debugging of any software is not possible. 


— 


sOoO-4zrLl1rzaw 
AOPEINUS 92S dWW0D KX1SL-ODWeAa 


Figure2.2.2 MB2147-05 System Set-up 
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2.2 System Configuration 


To work with the MB2147-05 some system configurations must be done as: 
- Insertion of Evaluation chip (EVA-Chip) 
- define clock supply for main clock 
- define clock supply for sub-clock 


- connection of C-Pin 


Note: To avoid any damages to the system, all configurations must be done when the 
emulation and target system is switched off from any power supply. 


2.2.1. Insert Evaluation Chip 


The following pictures show the evaluation chip and the corresponding configuration 
switches and jumpers. 


To insert the evaluation chip lift the lever beside the socket and insert the chip in the right 
position. Pin 1 of the evaluation chip is marked with a golden rectangle. Beside the socket a 
black arrow on the metal case of the emulator is marking Pin 1 position of the socket. The 
following picture shows the right position of EVA-Chip. After insertion of the chip, the lever 
can be removed to its horizontal position, fastening the EVA-Chip in the socket. 


N ‘Te 


Figure2.3.1.1 Configuration Area for the Evaluation Chip 
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2.2.2 Supply of Clocks to the evaluation Chip 


2.3.2.1 Configuration of Main Clock Supply 


In case a crystal is used for the clock supply, it is highly recommended to use the crystals 
mounted on the emulator system. Otherwise clocks might not work correctly. 


The mounting of the main crystal is done in SC4 and is shown in the next figure. For the 
capacitors mostly 22pF or 33pF are preferred values. 


Figure 2.3.2.1.1 Crystal Mounting Example 


To define the usage of the main and sub-clock pins the settings of SW3 and S7 must be 
checked. The following schematic show the crystal peripheral circuit. 


Evaluation MCU 
p o—+—<"_ PA1/XOA 
PA2/X1AL-126 OO +25 PA2/X1A 


S7 
GND GND fOOlc XOA 
ego 
390 KLE —<——j 
32.768 kHZ ABC 
I = 10pF/50 V 


GND GND 


33pF/50 V 


Figure 2.3.2.1.2 Crystal Peripheral Circuit 
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The main clock supply is selected by the switches 1 and 2 of SW3. The following table show 
the settings, depending whether the crystal on the crystal area is used or the clock is 
supplied from the target system. Note: If the clock is supplied from the target system, the 
influence of the probe cable must be considered. If a crystal is used on the target system, it 
is highly recommended to use the crystal area on the emulation system. 


SW3 Setting 
Function 
SW3.1 SW3.2 
Clock supply by Crystal installed on emulator OFF OFF 
Clock supply by clock supply on target system ON ON 


Table 2.3.2.1.1 Main-Clock Switching Settings 


2.3.2.2 Configuration of Sub-Clock supply 


S7 is used to configure the function of the sub-clock pins. Because on some microcontrollers 
the sub-clock pins are used as IO ports, the Configuration for these pins is as shown in table 
2.3.2.2.1. Note: If a sub-clock crystal is used, it is highly recommended to use the sub-clock 
mounted on the emulation system. 


Function S7 Setting SW3 Setting 
SW3.3 | SW3.4 

Sub-clock Function A-B OFF OFF 

Port Function B-C ON ON 


Table 2.3.2.2.1 Configuration of Sub-clock Switching Jumper S7 


2.3.2.3 C-Pin Switching 


In case the C-Pin of the EVA-Chip must be connected to an external capacitor, in order to 
buffer the internal core supply voltage, the following configuration must be performed. 


SW3 


Evaluation MCU 29 


0.1nF/50 V 


3i 
4 
b7oc110 S| 4% P70 
5 1 
7 
7 


3 
att 


Figure 2.3.2.3.1 C-Pin Switch Peripheral Circuit 
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C-Pin Function SW3 Setting 
SW3.5 SW3.6 

Provided OFF ON 

Not Provided ON OFF 


Table 2.3.2.3.1 Setting of SW3 for C-Pin configuration 


2.3.2.4 User Data Bus Switching Configuration 


When the probing target CPU pins (POO to P07, P10 to P17) are based on a special 
specification e.g. for high voltage ports, the user data port bus probing circuit must be set 
OFF via SW1, SW2. For more details on this configuration please check the description in 
the hardware manual. 


2.2.3 Example Configuration 
The following table show an example configuration for MB90V540 and MB90V495. 


SW3.1 | SW3.2 | SW3.3 | SW3.4 | SW3.5 | SW3.6 | SW3.7 | SW3.8 S7 


OFF |OFF |OFF |OFF |OFF [ON  |OFF_ | OFF A-B 


SW1 SW2 


All switches OFF | All switches OFF 


Table 2.3.3.1 Example Configuration of SW3 


The following table show an example configuration for MB90V590 and MB90V595. 


SW3.1 | SW3.2 | SW3.3 | SW3.4 | SW3.5 | SW3.6 | SW3.7 | SW3.8 $7 


OFF OFF ON ON OFF ON OFF OFF B-C 


SW 1 SW2 


All switches OFF | All switches OFF 


Table 2.3.3.2 Example Configuration of SW3 
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3 Software Installation 


3.1. Installation of Softune Workbench 


To work with the emulator MB2147-05 Softune Workbench V30L28 (ProPack300013) or 
higher must be used. Included in the shipping of the MB2147-05 is a CD-ROM containing 
the corresponding software package. To install the Softune Workbench start the 
corresponding installation set-up and follow the installation instructions. 


3.2 Installation of Communication Interface Drivers 


3.2.1 RS 232 communication 


If the communication to the ICE is going via RS232 no special drivers have to be installed. 
Just connect the RS232 interface of the ICE to the RS232 interface of the PC using the 
serial cable supplied with the ICE. 


3.2.2 USB communication 
If the communication to the ICE is going via the USB interface a special USB driver must be 
installed. To install the USB drivers perform the following steps: 

- Switch on the PC 

- switch on the ICE 


- connect the ICE to the PC 


As soon as the ICE is connected to the PC the new hardware will be recognized 
automatically and the standard windows dialog will appear to install the corresponding 
drivers. The USB drivers can be found in the Softune/Drivers directory on the CD-ROM 
delivered with the compact ICE or will be available separately as a zip file in case the 
Microcontroller CD-ROM V3.4 (available Q1/2003) is used. Use this USB driver if you are 
ask for special USB drivers to be installed for the ICE. 
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4 Set-up Debug Configuration 


4.1 Configure Debug Set-up 


When the Softune Workbench and the communication drivers have been installed the 
debugger set-up file must be configured first before starting the debugger. For this purpose 
the following steps must be performed. 


- Open your Softune Workbench project using the <File>, <Open 
Workspace> menu. 


| File Edit View Project Debug 
New... 
Open... Ctrl+0 


(lose 


Open Workspace. 
Close Workspace 


Save... Ctrl+S 
Save As... 
Save All 


eine 


Recent Text File » 
Recent Workspace File » 


Exit 


- The upcoming dialog allows you to specify the project / workspace file. 
Select the corresponding project file. Either select the .prj or .wsp file. 
If the project has been developed with a previous Softune Workbench 
version, the file type will be converted: select file type .prj for older 
Softune workbench projects or .wsp for projects developed with newer 
Softune Workbench versions supporting — 


Open Workspace 


Lookin fEQiorot = tt ts] | A | ao 


(Ste 
Doc |x] 10Port. prj 


Filename fiOPotp) = ===SSOSOSC*~S~S 
Files of type: | Project File(* a) Cancel _| 
Zi 


- lf a.prj file is selected, the project file will be converted automatically 
by Softune Workbench into a .wsp file. 


SoftuneS07 


Ci) 10200: This project file is old version. 


Convert it? 
i Cancel | 
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- After the conversion the project browser window shows the open 
project with the corresponding project files 


gs Softune Workbench - Reload 


File Edt View Project Debug Setup Window Help 
Coc] ta] [elm] eel saa taal Pee es 
| Reload ¥. | Debug x] 


{Bd Workspace'Reload! 
E- Reload_abs - “Reload.prj" [Debug] 

(9 Source Files 

{2 Include Files 

=) Dependencies 


=|“) Debug 
f ~® emulate. sup 
~~ sf} simulate. sup 


- To set-up the debugger configuration use the <Project>, <Setup 
Project> menu and select the Debug tab in the upcoming dialog. 
Select for category “Setup”. Now a Debug set-up name can be 
entered e.g. MB2147-05 USB. With the <Add> button the debug set- 
up wizard will be started to do some special configuration settings. 


Target of setting: Assembler | Linker | Librarian | Converter Debug | «(>| 


Debug | Category: | Setup x | 
Available Setup Name: 
JMe2141-05 USB x] 
Setup Name: Add... | 
[MB2141 05 USB Browse... | 
Setup Name List: Change Setup Name | 
Change... | 
Delete | 


a ee 


Alternately you can use the right mouse button on the Debug item in the 
browser window. 


i Workspace'Reload! 
a {B) Reload.abs - “Reload. prj" [Debug] 
+)-(29 Source Files 
‘of 9 Include Files 
=| Dependencies 
fon fA) mb90540.h 


i. ow Reference... 
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- Follow now the instructions of the wizard in the following set-up menus 


Setup Wizard 


Set-up Wizard start dialog 


Setup Wizard 


Select Debugger type 


Setup Wizard 


f 


Select Emulator System 


© Fujitsu Microelectronics Europe GmbH - 17- MCU-AN-390077-E-V11 


Pe) 
FUJITSU 


Chapter 4 Set-up Debug Configuration 


Setup Wizard 


Select automatic emulator firmware download. 
Note 


It is highly recommended to remove this selection for security 
reasons afterwards, as soon as the emulator firmware has been 
programmed. 


Setup Wizard 


Select optional batch file to be started after debugger start 
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Setup Wizard 


Finish wizard Set-up 
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After the set-up wizard is finished, the debugger can be started with its configured settings. 
In the browser window the default debugger is marked with a blue colour. The debugger is 


started via double-click on the item in the browser window or via the <Debug>, <Start 
debug> menu. 


Workspace'Reload! 
=] Reload.abs - “"Reload.prj" [Debug] 
#}-(29 Source Files 
(9) Include Files 
=} 4 Dependencies 
fH) mb90540.h 
= [Debug 
i) emulate.sup 
-EM MB2141-05 USB.sup 
{st} simulate. sup 


To change the debug set-up just use the right mouse button on the corresponding debug 
item in the browser menu. This will open a drop down menu to modify/delete the debug set- 
up. 


Workspace'Reload! 
=|) Reload.abs - “Reload.prj" [Debug] 
(29 Source Files 
{9 Include Files 
-}- 84 Dependencies 
i fH) mb90540.h 
=} Debug 
~~ emulate. sup 
a BM 


{st} simulate. sup Start Debug 


Change... 


Delete 


Property... 


When the debugger is started the first time, the firmware will be downloaded automatically. 
This will be indicated by the following information box. 


Load of monitor program es 


Now loading monitor program. 
C:\Tino\S oftunel BSLIB\SO74EMLS07C. mhz 


34% 


ad 
A load debug file notification will be displayed afterwards and the debug source window is 
opened, ready to set breakpoints, open watch-, register, memory- window, ... 


Now first remove the selection “Monitor-load auto-program” in the emulator setup, 
before you start further debugging (described on page 18). 
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Softune Workbench - 10Port - Debug 


Edit View Project Debug Setup Window Help 


Ojala) 2| oe) Halal Elia) Sele") S{eiles| |) lal eleo| #] ala SIO) AP) AL AL aI 


‘(By Workspace'l0 Pott’ 
(2) 10Port.abs - “IOPort.prj" [De 
Ey Source Files 
io Main.c 
of) mb90540.asm 
-D) readme.txt 
-R) Start.asm 
--[@) vectors.c 
(2 Include Files 
£3) Dependencies 
ow mb90540.h 
: aa Debug 
EN emulate. sup 
EM Emulator Com1 19200. sug 
~~ EM) MB2147-05 COM1 115k.s 
ger 


‘- [Sf) simulate. sup 


Tie ee eo ie eo a | 


MOY ILM,#? 


MOV RP, #REGBANK 


: ; Set clock ratio (ignore subclock) 


: #it CLOCKSPEED != NOCLOCK 


SETB I:CKSCR:2 


if CLOCKSPEED > MAINCLOCK 


Moy A, I:CKSCR 
AND A, #0xFC 


if CLOCKSPEED == PLLx2 


OR a, #0x01 


elif CLOCKSPEED == PLLx3 


OR A, #0x02 


elif CLOCKSPEED == PLLx4 


OR A, #0x03 
endif 
MOV I:CKSCR, A 


7 set interrupt level mask to i 
; set register bank pointer 


* set main clock 


? copy clock register 
; set xl for PLL 


? set x2 for PLL 


FFFFOOFF 
SP:000000 
FP: OOF FFF 
IP: FFOOO1 ILM:0 


0 ADB:00 
IDPR:01 USB:00 

000 $5B:00 

000 PCB:FF 


————— —————————— 


The available debug items/commands can now be executed via the corresponding icons in 
the main menu line, the <Debug> or <View> menu. 
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5 Appendix 


5.1 Trouble Shooting 
The debugger starts with a message as: Communication error ... 


Please check that the target is connected to the emulator system and the emulator and 
target system is powered-on. 


Check that in the emulator set-up (chapter 4.1) the topic “Select automatic emulator 
firmware download’ is selected. 


Check the DIP-switch and jumper settings for the crystal area (chapter 2.2.2). 


If working via USB please ensure that the USB drivers provided on the Softune 
Workbench CD-ROM has been installed correctly. Alternately a RS232 communication 
could be used first to prove that the other hardware settings of the emulator system have 
been done correctly. 


5.2 Monitoring 


Unfortunately the Low-Cost Emulator MB2147-05 does not support ‘online’-monitoring of 
variables, memory, registers, etc. The watch-window will only be updated while the emulator 
is stopped e.g. by a breakpoint. 

As a workaround ‘monitoring’ can be emulated as follows: 


1. Within your application use a timer function with IRQ handler (e.g. ReloadTimer). 
In the IRQ handler just reset the IRQ flag. 


2. Seta breakpoint into the Timer IRQ handler. 


15: void main({void) 


DO sé: 


18: /* One timer is needed to emulate monitoring using the Compact ICE MB2147-05. / 
19: /* Set a breakpoint witin the interrupt handler. +f 


2l: THRLRO 
22: THCSRO 


OxFFOO; /* The reload value defines the monitor refresh time *; 
Ox81B; /* Enable Timer, enable interrupt iy 


24: InitIrqgLevels(); /* Interrupt table and levels are defined in vector.c +; 


_ set_il(7?); /* Set ILM to 7 in order to allow all interrupts levels */ 
TE) /* Enable all interrupts at all “/ 


29: /* Place your code here +f 


sii while {1) 
32: { 

33% i=itl; 
34: } 

shR 


TH 5 GES 


37: /* This timer interrupt handler is needed to emulate monitoring. *; 
38: /* using the Compact ICE MB2147-05. Set a breakpoint here. Ls 


40: _ interrupt void ReloadTimerO (void) 


4l: { 
3 42: TMCSRO_UF = 0; /* reset underflow interrupt request flag */ 
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3. Use the following procedure file e.g.: ‘monitor.prc’ executed after load target file 


filename: MONITOR.PRC 


# emulation of monitoring function: 


JHILE J 


ENDW 


This procedure starts debugger and re-starts debugger after break by a while loop. 


Optional the procedure file can be assigned to a tools button using the following dialog: 
View, Customize bar, settings 


In this case the procedure file can be started by a click to a customized button. 


Restrictions of the ‘monitoring’ workaround described above: 
= Timer with IRQ is needed. 
= No Real-Time monitoring. 


«Timer IRQ handler and break/restart of debugger influence the timing and 
performance of the application. 
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